Upload Media
Upload your own media resources.
Introduction
This document will guide you on how to upload your own media files (such as images or audio) via the Jogg.ai API. After a successful upload, you will receive a Jogg.ai-hosted URL, which can be used in other API calls, for example, as a video background or a custom voice source.
Core Concept: Obtaining a Hosted URL
Why use this API?
When creating a video, certain parameters (like background_url
or audio_url
) require a publicly accessible URL. If your media file is not on a public server, you can use this API to upload the file to Jogg.ai’s secure servers to obtain a temporary, usable hosted URL.
Even if you have a publicly accessible URL, we still recommend uploading it to Jogg.ai’s secure servers, as your own URL might cause the task to fail due to network instability.
- Process:
- Upload your local file via this API.
- The API returns a JSON response containing a
media_url
. - In your API request to create a video, use this
media_url
as the value for the corresponding parameter.
- Request Format: File uploads must use the
multipart/form-data
request body format.
Step 1: Obtain sign_url and asset_id
You can upload media to obtain your sign_url
and asset_id
.
sign_url
: Used as the address to upload media.asset_id
: Gets the address of the uploaded resource.
Please refer to the Upload Media for more details.
Request:
Response:
You can upload pictures, videos, audio and other media resources.
Step 2: Use sign_url to upload the file
Use the following cURL command to upload the file to the server. Make sure to replace <file-binary-data> with the actual binary data of the file.
Request:
Pesponse:
Now asset_id
is an available address to get resources.
Step 3: Use asset_id to get the file
Here’s an example: